.TH E1432_SET_TRIGGER_LEVEL 3 E1432
.SH NAME
.nf
e1432_set_trigger_level \- Set trigger level
e1432_get_trigger_level \- Get current trigger level
.fi
.IX e1432_set_trigger_level(3) 3
.IX e1432_get_trigger_level(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_trigger_level(E1432ID hw, SHORTSIZ16 ID,
                                   SHORTSIZ16 whichLevel,
                                   FLOATSIZ32 level)
SHORTSIZ16 e1432_get_trigger_level(E1432ID hw, SHORTSIZ16 ID,
                                   SHORTSIZ16 whichLevel,
                                   FLOATSIZ32 *level)
.cE
.SH DESCRIPTION
\fIe1432_set_trigger_level\fR sets one of the two trigger levels, of a
single channel or group of channels \fIID\fR, to the value given in
\fIlevel\fR.

\fIe1432_get_trigger_level\fR returns one of the two current trigger
levels, of a single channel or group of channels \fIID\fR, into a
memory location pointed to by \fIlevel\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIwhichLevel\fR selects one of the two trigger levels.
\fBE1432_TRIGGER_LEVEL_LOWER\fR sets the low level,
\fBE1432_TRIGGER_LEVEL_UPPER\fR sets the high level.

\fIlevel\fR is the value of the trigger level, expressed as a
percentage of the current input range.  Its value can be from roughly
\fB-125%\fR to \fB+125%\fR.  

For a tach channel, there is no "full scale", so the trigger level is
expressed as an absolute voltage.  The Option AYF tachometer board can
set the trigger level between +-25 Volts.

For source channels, this function is not used, since it doesn't make
sense to specify a trigger level for a source.
.SH "RESET VALUE"
After a reset, the lower level is set to
\fB-10%\fR for input channel and \fB-0.05\fR volts for tach channels.  The
higher level is set to \fB0%\fR for input channels and \fB0.0\fR volts for
tach channels.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_trigger_mode, e1432_set_trigger,
e1432_get_trigger_level_limits
.ad
